Render ticket

Descripción general

El endpoint Render Ticket permite construir una página personalizada de tickets al proporcionar información detallada de cada ticket especificado por sus ticketIds. Este endpoint es crucial para integrar actualizaciones de estado de los tickets en tiempo real y realizar acciones, como ventas o visualización de detalles del ticket, directamente en la boletera.

Este es un endpoint de alta prioridad, diseñado para manejar solicitudes a gran escala de manera eficiente, garantizando respuestas rápidas y con los recursos necesarios para acciones críticas en tiempo real relacionadas con los tickets.

Propósito

La funcionalidad Render Ticket es ideal para:

• Mostrar el estado de los tickets (e.g., En Venta, Disponible, Vendido).
• Proporcionar acciones relacionadas con los tickets (e.g., Vender ticket, Ver detalles del ticket).
• Personalizar las páginas de tickets basadas en la autorización del usuario y los detalles del ticket asociado.
• Soportar acciones de reventa en el mercado de reventa de menta tech.

Información del Endpoint

URL
GET https://api.mentatech.io/v1/wrapper/tickets/render/list

Parámetros de consulta (Query Parameters)

Parámetro	Requerido	Descripción
ticketIds	Sí	Lista de IDs de tickets separados por comas. Ej: T001,T002,T003.
user	Sí	Email del usuario que solicita la información de los tickets.
loginTrust[user]	Opcional	Si se utiliza la funcionalidad LoginTrust, proporciona el email del usuario autorizado.

Ejemplo de solicitud

curl --location -g 'https://api.mentatech.io/v1/wrapper/tickets/render/list?ticketIds=T001%2CT002%2CT003&user=example%2540mentatech.io&loginTrust[user]=example%2540mentatech.io' \
--header 'Authorization: YOUR_API_KEY'

Respuesta

La respuesta contiene detalles del ticket como el estado del ticket, posibles acciones a realizar (e.g., ver o vender tickets) y URLs para realizar dichas acciones.

Respuesta JSON

{
  "data": {
    "count": 3,
    "results": [
      {
        "source": "PARAMETER",
        "structure": {
          "displayQr": false,
          "status": "SOLD",
          "tertiaryButton": {
            "action": "SELL_DETAILS",
            "callToAction": "Ver Info",
            "url": "https://ticket-info.mentatickets.com/es/65fdca5614b38dc6525ef1b4/listing?listingId=65fdca5614b38dc6525ef1b4&ticketSellerId=2"
          }
        },
        "ticketId": "T001"
      },
      {
        "source": "PARAMETER",
        "structure": {
          "displayQr": false,
          "primaryButton": {
            "action": "SELL_ITEM",
            "callToAction": "Vender",
            "url": "https://sell-ticket.mentatickets.com/es/publish/65fdc7eb0b281c64f937636d?oneTimeToken=eyJlbWFpbCI6ImV4YW1wbGVAbWVudGF0ZWNoLmlvIiwib3R0IjoiNTUyNjE5MDU3ODQiLCJ1c2VkIjpmYWxzZSwidGlja2V0U2VsbGVySWQiOiIyIiwiX2lkIjoiNjYwZDY2N2E5M2E2MjhjODg1OTk2OWEyIn0%3D&ticketSellerId=2"
          },
          "status": "AVAILABLE"
        },
        "ticketId": "T002"
      },
      {
        "source": "PARAMETER",
        "structure": {
          "displayQr": false,
          "primaryButton": {
            "action": "SELL_ITEM",
            "callToAction": "Vender",
            "url": "https://sell-ticket.mentatickets.com/es/publish/65fdc7ee7dee3439fc0206d9?oneTimeToken=eyJlbWFpbCI6ImV4YW1wbGVAbWVudGF0ZWNoLmlvIiwib3R0IjoiNTUyNjE5MDU3ODQiLCJ1c2VkIjpmYWxzZSwidGlja2V0U2VsbGVySWQiOiIyIiwiX2lkIjoiNjYwZDY2N2E5M2E2MjhjODg1OTk2OWEyIn0%3D&ticketSellerId=2"
          },
          "status": "AVAILABLE"
        },
        "ticketId": "T003"
      }
    ]
  },
  "errors": [],
  "status": 200
}

Campos de la respuesta

• count: Número total de tickets devueltos.
• results: Un array de objetos de tickets que contiene:
  • ticketId: El identificador del ticket.
  • status: El estado actual del ticket (e.g., SOLD, AVAILABLE).
  • structure: Contiene varias acciones para el ticket, como:
    • primaryButton: La acción principal disponible para el ticket (e.g., "Vender").
    • tertiaryButton: Opciones adicionales de información o acciones (e.g., "Ver Info").
    • url: Enlace directo para realizar la acción relacionada con el ticket.

Funcionalidad LoginTrust

La funcionalidad LoginTrust permite la autenticación transparente de usuarios dentro de la infraestructura de menta tech. Al incluir el parámetro loginTrust[user], la API puede autenticar la solicitud en nombre del usuario especificado, sin requerir un proceso de inicio de sesión posterior en menta.

Para utilizar esta funcionalidad, añade lo siguiente a tu solicitud:

loginTrust[user]=example@mentatech.io